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REFERENCE: An APPLE II package for 
storage and retrieval of journal references 
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The package described here enables the user to maintain a "card index system" of journal 
references on floppy disk, with easy retrieval of references by author, subject, or combination of 
subjects. 



Many scientists maintain a card index system of 
journal references. The organization of such a system 
can pose a problem. To file references alphabetically 
by author makes for easy access to a particular refer- 
ence, but it is cumbersome if one wants quickly to 
locate all references relevant to a given topic. Filing by 
topic avoids this problem, but this does not work 
efficiently for references that are relevant to more than 
one topic. These problems can be overcome by using a 
microprocessor to store on random-access files the 
information that would normally be kept on index 
cards. The computer package described here enables 
the user to maintain a "card index system" on floppy 
disk, with easy retrieval of references by author, subject, 
or combination of subjects. 

Of course, in many respects, such programs cannot 
compete with the large library search systems now 
available in many universities. The microprocessor 
searches comparatively slowly, and one has available 
only those references that have been typed in. The 
program package described here would not be cost- 
effective for someone who found typing laborious and 
did not have secretarial help. 

Two advantages of having a personalized index 
system based on a microcomputer are cost and avail- 
ability. Perhaps the most useful aspect is the facility to 
develop a reference system coded to personal specifica- 
tions. The subject codings used by library search systems 
are rational and fairly comprehensive, but they seldom 
correspond to the optimal partitioning of the topic for 
any one specialist. Using the computer package 
described here, a set of references can be coded into as 
many subject categories as one wishes. The categories 
can be as broad or narrow as the user desires, and idio- 
syncratic categories (e.g., a classification of articles in 
terms of methodology, as well as subject matter) are 
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possible. Furthermore, additional categorizations can be 
incorporated (e.g., coding whether the user has a reprint 
of the article, where the journal is located, or whether 
the article in question is good, bad, or indifferent). 

SYSTEM REQUIREMENTS 

The programs require an APPLE II microprocessor 
with 48K of memory and two disk drives. A printer is 
extremely useful but not essential. The programs are 
written in APPLESOFT BASIC. 

HOW THE PACKAGE WORKS 

One program, CODING FILE, is used only once, to set up 
codings for journals, book publishers, and subject categories 
before using the main program, INDEX, for the first time. Cod- 
ings are stored at the end of the INDEX program as a series of 
DATA statements. CODING FILE takes the tedium out of this 
operation by automatically sorting journal titles, book pub- 
lishers, and subject categories alphabetically and by writing these 
as a series of DATA statements preceded by line numbers onto 
text files. The EXEC command is then used to append these 
lines to the end of the INDEX program. INDEX can then be 
saved with these new lines. 

Sample Run of CODING FILE 1 

RUN 

CODING FILE 
THIS PROGRAM SHOULD BE RUN BEFORE RUNNING 
'INDEX' FOR THE FIRST TIME 

TYPE IN YOUR LIST OF JOURNALS ENDING EACH 
WITH 'RETURN' (MAXIMUM OF 200 JOURNALS) 
DO NOT USE COMMAS OR COLONS 

TYPE > INSTEAD OF , 

TYPE # INSTEAD OF : 

^NEUROPSYCHOLOGY 

1BEHA VIOR RESEARCH METHODS AND 

INSTR UMENTA TION 

? CORTEX 

? (return) 



TYPE IN YOUR LIST OF BOOK PUBLISHERS ENDING 
EACH WITH 'RETURN' 

WHEN ALL ARE ENTERED PRESS 'RETURN' 
(MAXIMUM OF 100 BOOK PUBLISHERS) 
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DO NOT USE COMMAS OR COLONS 
TYPE > INSTEAD OF , 
TYPE # INSTEAD OF : 

WILLIAMS AND WIL KINS # BALTIMORE 
^ACADEMIC PRESS '# NEW YORK 
1 (return) 

TYPE IN YOUR LIST OF SUBJECTS ENDING EACH 
WITH * RETURN 1 

WHEN ALL ARE ENTERED PRESS 'RETURN' 
DO NOT USE COMMAS OR COLONS 

TYPE > INSTEAD OF , 

TYPE # INSTEAD OF : 

^HANDEDNESS 
^COMPUTING 
1 BRAIN DAMAGE 
? CHILDREN 
1 (return) 

YOUR JOURNALS, BOOK PUBLISHERS AND SUBJECTS 
ARE NOW STORED IN TEXT FILES 
YOU ARE NOW READY TO START USING THE 
PROGRAM CALLED 'INDEX' 

BEFORE RUNNING 'INDEX' FOR THE FIRST TIME, 
CARRY OUT THE FOLLOWING OPERATIONS 

LOAD INDEX 
EXEC JOURNALS 
EXEC BOOK PUBLISHERS 
EXEC SUBJECTS 
SAVE INDEX 

YOU WILL THEN BE READY TO: 

RUN INDEX 

The initial codings set up by CODING FILE are not immu- 
table. It is always possible to add a new category by typing in a 
new DATA statement at the end of the relevant section of the 
INDEX program. 

There is no limit to the number of subject categories, but 
their selection should be given careful thought. I found it useful 
to include both broad and narrow categories. When selecting 
categories, the user is not restricted to a single category when 
searching for references by subject. Also, the user will have the 
facility to search for articles on the basis of negative as well as 
positive categories (e.g., you can search for articles covering 
handedness but not children). 

Before describing the INDEX program, it is necessary to 
describe reference file organization. Mini-floppy disks are very 
limited in capacity, and random-access files, which are ideal for 
easy access to selected files, are uneconomical in their use of 
space. Even with an optimal coding system, it is not possible 
to store many references on a single disk. This package, 
therefore, uses pairs of disks to store data. Information that is 
used to access references (i.e., authors and subject codings, 
as well as the journal reference and date) are stored on a file 
called REFERENCE in Drive 1; titles of articles, which require 
a great deal of storage space but are not used to retrieve articles, 
are stored on a TITLES file in Drive 2. Using this format, it is 
possible to store approximately 530 references on a pair of 
mini-floppy disks. A further feature to maximize easy access 
is that both types of files are labeled by the initial letter of the 
first author (e.g., REFERENCE A, REFERENCE B, etc.). 
Thus, with large collections of references, files corresponding 
to different letters of the alphabet are stored on separate pairs 



of disks (e.g., REFERENCE A to REFERENCED on one 
disk, with TITLES A to TITLES D on a corresponding disk; 
REFERENCE E to REFERENCE H on another, etc.). Should 
the number of references expand unexpectedly, it is easy to 
transfer a pair of files to a new disk using the TRANSFER 
program. This system is quite workable with a set of some 4,000 
references, currently held on 10 disk pairs, which leaves a lot 
of room for expansion. 

When INDEX is RUN, the user is instructed to put the 
appropriate REFERENCE disk in Drive 1 and TITLES disk in 
Drive 2 and is then jsresented the following menu: 

WRITE IN NEW REFERENCE (1) 

WRITE TO NUMBERED RECORD (2) 

SEARCH FOR REFERENCE BY AUTHOR (3) 

SEARCH FOR REFERENCE BY SUBJECT (4) 

SEARCH FOR ANY OCCURRENCE OF AUTHOR (5) 

PRINT OUT NUMBERED REFERENCE (6) 

PRINT OUT WHOLE FILE (7) 

PRINT OUT JOURNAL CODINGS (8) 

PRINT OUT SUBJECT CODINGS (9) 

END (10) 

Write in New Reference: Sample Run 

YOU WILL NOW BE ASKED TO TYPE IN DETAILS 
FOLLOW EACH WITH 'RETURN' 
FIRST ENTER THE AUTHORS 

TYPE IN EACH SURNAME FOLLOWED BY INITIALS, 

THEN PRESS 'RETURN' 

DO NOT USE COMMAS 

INSTEAD OF A COMMA USE *>' 

WHEN YOU HAVE TYPED IN ALL AUTHORS, JUST 

PRESS 'RETURN' TO SIGNAL YOU ARE READY TO 

GO ON. 

AUTHOR? KRASHEN> S. 
AUTHOR? (return) 

DATE? 1975 

NOW ENTER TITLE 

(IF ARTICLE IS IN A BOOK OR UNCODED JOURNAL, 
ADD THESE DETAILS AT THE END OF THE TITLE, 
IF THE WHOLE ENTRY DOES NOT EXCEED 200 
CHARACTERS) 

TITLE? THE CRITICAL PERIOD OF LANGUAGE 
ACQUISITION AND ITS POSSIBLE BASIS 

NOW ENTER REFERENCE CODING 
USE THE FOLLOWING FORMAT: 
FOR JOURNAL ARTICLES 
J>V>P1-P2 

WHERE J IS CODE NUMBER OF JOURNAL 
V [S VOLUME NUMBER 
PI AND P2 ARE PAGE NUMBERS 

FOR BOOK PUBLISHER, JUST TYPE IN CODE NUMBER 
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FOR DETAILS OF BOOK NOT INCLUDED IN TITLE, 
TYPE 'B' 

FOR UNPUBLISHED ARTICLES TYPE '200' 

IF ALL DETAILS ALREADY SPECIFIED WITH TITLE, 
TYPE '0' 

?13>263>2l 1-224 

NOW ENTER SUBJECT CODING 

TYPE ALL RELEVANT CODE NUMBERS SEPARATED 
BY SPACES, THEN PRESS 'RETURN' 

CODING? 24 36 107 

NOW CHECK THIS ENTRY 

FOR EACH PIECE OF INFORMATION, PRESS 'RETURN' 
IF ALL OK, PRESS ANY OTHER KEY IF NOT 

CODING 

24 36 107 
1 (return) 

DATE 

1975 
? (return) 

REFERENCE CODE 

13>263>211-224 
1 (return) 

AUTHORS 

KRASHEN> S. 
^(return) 

TITLE 

THE CRITICAL PERIOD OF LANGUAGE 
ACQUISITION AND ITS POSSIBLE 
BASIS 

?7V 

CORRECT TITLE? 

THE CRITICAL PERIOD FOR LANGUAGE 
ACQUISITION AND ITS POSSIBLE BASIS 

TITLE 

THE CRITICAL PERIOD FOR LANGUAGE 
ACQUISITION AND ITS POSSIBLE BASIS 
? (return) 

NOW WRITING REFERENCE ON DISK 
RECORD NO. 173 

DO YOU WANT TO ENTER ANOTHER (Y/N)? 

The reference is written onto the next record on the 
REFERENCE file. The total number of records on the file is 
stored in Record 0. References occurring in books must be 
handled separately, since codings are not available for books. 
A space-saving way is to add the book details to the end of the 
title and then give the code for journal reference. If the book 
details are too long, then the user can specify B in response to 
the request for a journal code, and he is then able to type 
in the book details, which are saved on a separate file called 
BOOKS $, where $ is the initial letter of the first author's name. 

Write to Numbered Record 

This option is similar to the first (write in new reference), 
but it allows the user to select the record number of the refer- 
ence and to overwrite old references if he wishes. 



Search for Particular Reference: Sample Run 

NOW SPECIFY AUTHORS. SEARCH WILL ONLY FIND 
AUTHORS IN CORRECT ORDER. 
YOU NEED NOT SPECIFY INITIALS, BUT IF YOU DO, 
ADOPT THE FOLLOWING FORMAT: 

BISHOP> D.V.M. 
WHEN ALL AUTHORS ENTERED, TYPE 'RETURN' IN 
RESPONSE TO THE 'AUTHOR' PROMPT 

AUTHOR? LURIA 
AUTHOR? (return) 

Any references in the system with Luria as sole author will now 
be printed on the screen. The user has the option of printing out 
references if he or she wishes. 

Search for Reference by Subject: Sample Run 

1 AND 2 

THIS IS SEARCH COMMAND, DO YOU WANT TO 
CHANGE IT? 
TYPE 'Y'OR 'N' 

IF YOU DON'T KNOW WHAT A SEARCH COMMAND IS, 
TYPE 'Y' 

?y 



REPLACE MAIN DISK IN DRIVE 1, THEN PRESS 
'RETURN' 

? (return) 

YOU MUST NOW SPECIFY A SEARCH STRING. USE 
CONSECUTIVE NUMBERS 1,2,3 ETC TO DENOTE 
SUBJECT CATEGORIES 

DO YOU WANT TO SEE SOME EXAMPLES OF SEARCH 
STRINGS? 

?V 

NOW TYPE IN SEARCH STRING 

?7 AND (2 OR 3) 

TO CONTINUE, NOW TYPE THE FOLLOWING 
COMMANDS EXACTLY AS SHOWN BELOW, 
FOLLOWING EACH WITH 'RETURN' 
(WAIT UNTIL THE DISK DRIVE LIGHT IS OUT BEFORE 
STARTING COMMAND 2) 

LOAD INDEX 

2870 

3170 

EXEC SEARCH STRING 
RUN 

LOAD INDEX 

2870 

3170 

EXEC SEARCH STRING 
RUN 

PUT REFERENCE DISK IN DRIVE 1 AND TITLES DISK 
IN DRIVE 2 

PRESS 'RETURN' WHEN READY TO CONTINUE 

1 (return) 

1 AND (2 OR 3) 

THIS IS SEARCH COMMAND. DO YOU WANT TO 
CHANGE IT? 
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TYPE <Y' OR 'NT 

IF YOU DONT KNOW WHAT A SEARCH COMMAND IS, 
TYPE 'Y* 

?A^ 

SUBJECT CODE CORRESPONDING TO 1? 31 
SUBJECT CODE CORRESPONDING TO 2? 24 
SUBJECT CODE CORRESPONDING TO 3? 5 

TYPE IN IDENTIFYING LETTER OF REFERENCE 
FILE? D 

SEARCH WILL TAKE A MINUTE OR TWO, DEPENDING 
ON FILE LENGTH. I WILL CALL YOU WHEN I AM 
READY 

The search is conducted one file ai: a time, with relevant 
references being printed on the screen af ter each file is searched. 
The program then stops to allow the user to specify a new file 
and, if necessary, to insert a new pair of disks. The time taken to 
search tlirough the whole reference collection will obviously 
depend on the number of disks involved, the complexity of the 
search command, and the number of references found. The user 
has the option of having each reference printed on the screen 
and then selecting those he wishes to print out using the printer, 
or of automatically printing out hard copy of all references that 
are found. My collection (approximately 4,000 references on 
10 disk pairs) takes an average of 30 min to search through 
completely. 

Search for Any Occurrence of Author 

This option is similar to the search for particular reference, 
but it enables the user to look for a reference in which a given 
person i:; listed as an author, irrespective of other authors. 



The author searched for need not be the first author, and one 
can thus search files other than those beginning with the author's 
initial letter, if necessary searching through the whole collection 
of references. 

Print Out Numbered Reference 

When references are printed out on a screen or printer, the 
record number is always printed out on the top right-hand 
corner. If the record number of a given reference is known, then 
that reference can be quickly accessed and printed on the screen 
and/or the printer. This instruction also gives the user the option 
of correcting references that contain errors. 

Print Out Whole File 

All references on a file are printed out on screen and/or 
printer. 

Print Out Journal Codings 

It is necessary to have a list of journal codings when entering 
new references. This instruction enables the user to obtain a 
list of journal codings with the journals in alphabetical order. 

Print Out Subject Codings 

This is the same as printing out journal codings, except that 
the subject codings are not automatically alphabetically sorted 
before printout. 



NOTE 

1 . Information entered by the user is printed in italic type. 
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